package com.example.service.service;

import com.example.service.entity.SystemTenant;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import java.util.List;
import java.util.Optional;

/**
 * 租户服务接口
 * 
 * @author example
 * @since 1.0.0
 */
public interface SystemTenantService {
    
    /**
     * 创建租户
     * 
     * @param tenant 租户对象
     * @return 创建后的租户对象
     * @throws IllegalArgumentException 如果租户名称已存在
     */
    SystemTenant createTenant(SystemTenant tenant);
    
    /**
     * 更新租户信息
     * 
     * @param tenant 租户对象
     * @return 更新后的租户对象
     * @throws IllegalArgumentException 如果租户不存在或租户名称已被其他租户使用
     */
    SystemTenant updateTenant(SystemTenant tenant);
    
    /**
     * 根据ID查找租户
     * 
     * @param id 租户ID
     * @return 租户对象
     */
    Optional<SystemTenant> findTenantById(Long id);
    
    /**
     * 根据名称查找租户
     * 
     * @param name 租户名称
     * @return 租户对象
     */
    Optional<SystemTenant> findTenantByName(String name);
    
    /**
     * 根据邮箱查找租户
     * 
     * @param email 租户邮箱
     * @return 租户对象
     */
    Optional<SystemTenant> findTenantByEmail(String email);
    
    /**
     * 根据电话查找租户
     * 
     * @param phone 租户电话
     * @return 租户对象
     */
    Optional<SystemTenant> findTenantByPhone(Long phone);
    
    /**
     * 查找所有租户
     * 
     * @return 租户列表
     */
    List<SystemTenant> findAllTenants();
    
    /**
     * 分页查询租户
     * 
     * @param pageable 分页参数
     * @return 租户分页结果
     */
    Page<SystemTenant> findTenantsByPage(Pageable pageable);
    
    /**
     * 查找所有未删除的租户
     * 
     * @return 租户列表
     */
    List<SystemTenant> findAllActiveTenants();
    
    /**
     * 查找所有正常状态的租户
     * 
     * @return 租户列表
     */
    List<SystemTenant> findAllNormalTenants();
    
    /**
     * 删除租户（逻辑删除）
     * 
     * @param id 租户ID
     * @return 是否删除成功
     */
    boolean deleteTenant(Long id);
    
    /**
     * 物理删除租户
     * 
     * @param id 租户ID
     */
    void removeTenant(Long id);
    
    /**
     * 检查租户名称是否已存在
     * 
     * @param name 租户名称
     * @return 是否存在
     */
    boolean isTenantNameExists(String name);
    
    /**
     * 检查租户邮箱是否已存在
     * 
     * @param email 租户邮箱
     * @return 是否存在
     */
    boolean isTenantEmailExists(String email);
    
    /**
     * 检查租户电话是否已存在
     * 
     * @param phone 租户电话
     * @return 是否存在
     */
    boolean isTenantPhoneExists(Long phone);
    
    /**
     * 查找授权用户数小于授权用户总数的租户
     * 
     * @return 租户列表
     */
    List<SystemTenant> findTenantsWithAvailableUserSlots();
    
    /**
     * 查找即将过期的租户
     * 
     * @param days 天数
     * @return 租户列表
     */
    List<SystemTenant> findTenantsExpiringInDays(int days);
    
    /**
     * 增加租户已用用户数
     * 
     * @param id 租户ID
     * @return 是否增加成功
     */
    boolean incrementReadyUserCount(Long id);
    
    /**
     * 减少租户已用用户数
     * 
     * @param id 租户ID
     * @return 是否减少成功
     */
    boolean decrementReadyUserCount(Long id);
} 